<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- /fasttmp/mkdist-qt-4.3.5-1211793125/qtopia-core-opensource-src-4.3.5/src/gui/graphicsview/qgraphicssceneevent.cpp -->
<head>
  <title>Qt 4.3: QGraphicsSceneDragDropEvent Class Reference</title>
  <link href="classic.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></a></td>
<td width="1">&nbsp;&nbsp;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&nbsp;&middot; <a href="classes.html"><font color="#004faf">All&nbsp;Classes</font></a>&nbsp;&middot; <a href="mainclasses.html"><font color="#004faf">Main&nbsp;Classes</font></a>&nbsp;&middot; <a href="groups.html"><font color="#004faf">Grouped&nbsp;Classes</font></a>&nbsp;&middot; <a href="modules.html"><font color="#004faf">Modules</font></a>&nbsp;&middot; <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top" width="230"><a href="http://www.trolltech.com"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></a></td></tr></table><h1 align="center">QGraphicsSceneDragDropEvent Class Reference<br /><sup><sup>[<a href="qtgui.html">QtGui</a> module]</sup></sup></h1>
<p>The QGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view framework. <a href="#details">More...</a></p>
<pre> #include &lt;QGraphicsSceneDragDropEvent&gt;</pre><p>Inherits <a href="qgraphicssceneevent.html">QGraphicsSceneEvent</a>.</p>
<p>This class was introduced in Qt 4.2.</p>
<ul>
<li><a href="qgraphicsscenedragdropevent-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h3>Public Functions</h3>
<ul>
<li><div class="fn"/><b><a href="qgraphicsscenedragdropevent.html#dtor.QGraphicsSceneDragDropEvent">~QGraphicsSceneDragDropEvent</a></b> ()</li>
<li><div class="fn"/>void <b><a href="qgraphicsscenedragdropevent.html#acceptProposedAction">acceptProposedAction</a></b> ()</li>
<li><div class="fn"/>Qt::MouseButtons <b><a href="qgraphicsscenedragdropevent.html#buttons">buttons</a></b> () const</li>
<li><div class="fn"/>Qt::DropAction <b><a href="qgraphicsscenedragdropevent.html#dropAction">dropAction</a></b> () const</li>
<li><div class="fn"/>const QMimeData * <b><a href="qgraphicsscenedragdropevent.html#mimeData">mimeData</a></b> () const</li>
<li><div class="fn"/>Qt::KeyboardModifiers <b><a href="qgraphicsscenedragdropevent.html#modifiers">modifiers</a></b> () const</li>
<li><div class="fn"/>QPointF <b><a href="qgraphicsscenedragdropevent.html#pos">pos</a></b> () const</li>
<li><div class="fn"/>Qt::DropActions <b><a href="qgraphicsscenedragdropevent.html#possibleActions">possibleActions</a></b> () const</li>
<li><div class="fn"/>Qt::DropAction <b><a href="qgraphicsscenedragdropevent.html#proposedAction">proposedAction</a></b> () const</li>
<li><div class="fn"/>QPointF <b><a href="qgraphicsscenedragdropevent.html#scenePos">scenePos</a></b> () const</li>
<li><div class="fn"/>QPoint <b><a href="qgraphicsscenedragdropevent.html#screenPos">screenPos</a></b> () const</li>
<li><div class="fn"/>void <b><a href="qgraphicsscenedragdropevent.html#setDropAction">setDropAction</a></b> ( Qt::DropAction <i>action</i> )</li>
<li><div class="fn"/>QWidget * <b><a href="qgraphicsscenedragdropevent.html#source">source</a></b> () const</li>
</ul>
<ul>
<li><div class="fn"/>1 public function inherited from <a href="qgraphicssceneevent.html#public-functions">QGraphicsSceneEvent</a></li>
<li><div class="fn"/>6 public functions inherited from <a href="qevent.html#public-functions">QEvent</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"/>1 property inherited from <a href="qevent.html#properties">QEvent</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QGraphicsSceneDragDropEvent class provides events for drag and drop in the graphics view framework.</p>
<p><a href="qgraphicsview.html">QGraphicsView</a> inherits the drag and drop functionality provided by <a href="qwidget.html">QWidget</a>. When it receives a drag and drop event, it translates it to a QGraphicsSceneDragDropEvent.</p>
<p>QGraphicsSceneDragDropEvent stores events of type <a href="qevent.html#Type-enum">GraphicsSceneDragEnter</a>, <a href="qevent.html#Type-enum">GraphicsSceneDragLeave</a>, <a href="qevent.html#Type-enum">GraphicsSceneDragMove</a>, or <a href="qevent.html#Type-enum">GraphicsSceneDrop</a>.</p>
<p>QGraphicsSceneDragDropEvent contains the position of the mouse cursor in both item, scene, and screen coordinates; this can be retrieved with <a href="qgraphicsscenedragdropevent.html#pos">pos</a>(), <a href="qgraphicsscenedragdropevent.html#scenePos">scenePos</a>(), and <a href="qgraphicsscenedragdropevent.html#screenPos">screenPos</a>().</p>
<p>The scene sends the event to the first <a href="qgraphicsitem.html">QGraphicsItem</a> under the mouse cursor that accepts drops; a graphics item is set to accept drops with <a href="qgraphicsitem.html#setAcceptDrops">setAcceptDrops()</a>.</p>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="dtor.QGraphicsSceneDragDropEvent"></a>QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent ()</h3>
<p>Destroys the object.</p>
<h3 class="fn"><a name="acceptProposedAction"></a>void QGraphicsSceneDragDropEvent::acceptProposedAction ()</h3>
<p>Sets the proposed action as accepted, i.e, the drop action is set to the proposed action. This is equal to:</p>
<pre> setDropAction(proposedAction());</pre>
<p>When using this function, one should not call <tt>accept()</tt>.</p>
<p>See also <a href="qgraphicsscenedragdropevent.html#dropAction">dropAction</a>(), <a href="qgraphicsscenedragdropevent.html#setDropAction">setDropAction</a>(), and <a href="qgraphicsscenedragdropevent.html#proposedAction">proposedAction</a>().</p>
<h3 class="fn"><a name="buttons"></a><a href="qt.html#MouseButton-enum">Qt::MouseButtons</a> QGraphicsSceneDragDropEvent::buttons () const</h3>
<p>Returns a <a href="qt.html#MouseButton-enum">Qt::MouseButtons</a> value indicating which buttons were pressed on the mouse when this mouse event was generated.</p>
<p>See also <a href="qt.html#MouseButton-enum">Qt::MouseButtons</a>.</p>
<h3 class="fn"><a name="dropAction"></a><a href="qt.html#DropAction-enum">Qt::DropAction</a> QGraphicsSceneDragDropEvent::dropAction () const</h3>
<p>Returns the action that was performed in this drag and drop. This should be set by the receiver of the drop and is returned by <a href="qdrag-obsolete.html#start">QDrag::start</a>().</p>
<p>See also <a href="qgraphicsscenedragdropevent.html#setDropAction">setDropAction</a>() and <a href="qgraphicsscenedragdropevent.html#acceptProposedAction">acceptProposedAction</a>().</p>
<h3 class="fn"><a name="mimeData"></a>const <a href="qmimedata.html">QMimeData</a> * QGraphicsSceneDragDropEvent::mimeData () const</h3>
<p>This function returns the MIME data of the event.</p>
<h3 class="fn"><a name="modifiers"></a><a href="qt.html#KeyboardModifier-enum">Qt::KeyboardModifiers</a> QGraphicsSceneDragDropEvent::modifiers () const</h3>
<p>Returns the keyboard modifiers that were pressed when the drag and drop event was created.</p>
<p>See also <a href="qt.html#KeyboardModifier-enum">Qt::KeyboardModifiers</a>.</p>
<h3 class="fn"><a name="pos"></a><a href="qpointf.html">QPointF</a> QGraphicsSceneDragDropEvent::pos () const</h3>
<p>Returns the mouse position of the event relative to the view that sent the event.</p>
<p>See also <a href="qgraphicsview.html">QGraphicsView</a>, <a href="qgraphicsscenedragdropevent.html#screenPos">screenPos</a>(), and <a href="qgraphicsscenedragdropevent.html#scenePos">scenePos</a>().</p>
<h3 class="fn"><a name="possibleActions"></a><a href="qt.html#DropAction-enum">Qt::DropActions</a> QGraphicsSceneDragDropEvent::possibleActions () const</h3>
<p>Returns the possible drop actions that the drag and drop can result in.</p>
<p>See also <a href="qt.html#DropAction-enum">Qt::DropActions</a>.</p>
<h3 class="fn"><a name="proposedAction"></a><a href="qt.html#DropAction-enum">Qt::DropAction</a> QGraphicsSceneDragDropEvent::proposedAction () const</h3>
<p>Returns the drop action that is proposed, i.e&#x2e;, preferred. The action must be one of the possible actions as defined by <tt>possibleActions()</tt>.</p>
<p>See also <a href="qt.html#DropAction-enum">Qt::DropAction</a> and <a href="qgraphicsscenedragdropevent.html#possibleActions">possibleActions</a>().</p>
<h3 class="fn"><a name="scenePos"></a><a href="qpointf.html">QPointF</a> QGraphicsSceneDragDropEvent::scenePos () const</h3>
<p>Returns the position of the mouse in scene coordinates.</p>
<p>See also <a href="qgraphicsscenedragdropevent.html#pos">pos</a>() and <a href="qgraphicsscenedragdropevent.html#screenPos">screenPos</a>().</p>
<h3 class="fn"><a name="screenPos"></a><a href="qpoint.html">QPoint</a> QGraphicsSceneDragDropEvent::screenPos () const</h3>
<p>Returns the position of the mouse relative to the screen.</p>
<p>See also <a href="qgraphicsscenedragdropevent.html#pos">pos</a>() and <a href="qgraphicsscenedragdropevent.html#scenePos">scenePos</a>().</p>
<h3 class="fn"><a name="setDropAction"></a>void QGraphicsSceneDragDropEvent::setDropAction ( <a href="qt.html#DropAction-enum">Qt::DropAction</a> <i>action</i> )</h3>
<p>This function lets the receiver of the drop set the drop action that was performed to <i>action</i>, which should be one of the <a href="qgraphicsscenedragdropevent.html#possibleActions">possible actions</a>. Call <tt>accept()</tt> in stead of <tt>acceptProposedAction()</tt> if you use this function.</p>
<p>See also <a href="qgraphicsscenedragdropevent.html#dropAction">dropAction</a>(), <a href="qevent.html#accept">accept</a>(), and <a href="qgraphicsscenedragdropevent.html#possibleActions">possibleActions</a>().</p>
<h3 class="fn"><a name="source"></a><a href="qwidget.html">QWidget</a> * QGraphicsSceneDragDropEvent::source () const</h3>
<p>This function returns the <a href="qgraphicsview.html">QGraphicsView</a> that created the <a href="qgraphicsscenedragdropevent.html">QGraphicsSceneDragDropEvent</a>.</p>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%">Copyright &copy; 2008 <a href="trolltech.html">Trolltech</a></td>
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">Qt 4.3.5</div></td>
</tr></table></div></address></body>
</html>
